$OpenBSD: README-main,v 1.25 2016/08/12 08:09:05 robert Exp $

+-----------------------------------------------------------------------
| Running ${FULLPKGNAME} on OpenBSD
+-----------------------------------------------------------------------

*** Upgrading users: refer to zarafa documentation on the web to check
*** if any particular step is required after upgrading to a new version.

6.40 -> 7.0 upgrade
===================

See http://doc.zarafa.com/trunk/Release_Notes/en-US/html/_upgrading_to_zcp_7_0.html

The zarafa7-upgrade script is available at:
    ${TRUEPREFIX}/share/doc/zarafa/zarafa7-upgrade
Note that this script requires the py-mysql package.

Post-install/update instructions for Zarafa
===========================================

By default the server is configured to accept SOAP connections on port
236. If you wish to connect Outlook clients on port 80, please setup
your web server to proxy HTTP requests with URI=/zarafa to
http://localhost:236.

It is advised to tune the MySQL installation according to:
    http://doc.zarafa.com/trunk/Administrator_Manual/en-US/html/_memory_usage_setup.html
    http://zarafa.com/wiki/index.php/MySQL_tuning
(especially for max_allowed_packet)

Before Starting zarafa-server for the first time
------------------------------------------------
A MySQL datatabase access needs to be configured in
    ${SYSCONFDIR}/zarafa/server.cfg

After zarafa-server was started for the first time
--------------------------------------------------
Creating the public store.
    # ${TRUEPREFIX}/sbin/zarafa-admin -s

Adding an admin user -- see zarafa-admin(1).
    # ${TRUEPREFIX}/sbin/zarafa-admin -c zadmin -p secret \
        -e zarafa.admin@domain.tld -f "John Doe" -a 2

Mail delivery agent configuration
=================================

See the following URL for other MTA integration:
    http://www.zarafa.com/wiki/index.php?title=MTA_integration&oldid=2487

Alternatively add the following .forward file under the user(s) home
directory that will use Zarafa:
"|${TRUEPREFIX}/sbin/zarafa-dagent <username>"

You can automate this step by copying
    ${TRUEPREFIX}/share/examples/zarafa/createuser.dotforward
to
    ${SYSCONFDIR}/zarafa/userscripts/createuser.d/
The .forward will be automatically generated when a new user is added to
Zarafa.

Zarafa webaccess
================

Zarafa Webaccess is obsolete and has been removed. Please
use zarafa-webapp.

Documentation and help
======================

Each zarafa-* command has its corresponding manpage.

Some documentation is also available at:
    http://www.zarafa.com/wiki/index.php/Main_Page
    http://doc.zarafa.com/trunk/Administrator_Manual/en-US/html/
